home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / sound / acp_101.zip / ACP.DOC next >
Text File  |  1996-05-20  |  12KB  |  341 lines
  1. Another CD Player Version 1.01 05/20/96
  2.  
  3. Program and documentation written by András Kékesi
  4.  E-mail addresses:
  5.   keki@goliat.eik.bme.hu
  6.   keki@atlantis.bme.hu
  7.  
  8. FastMem Unit (version 3.2) written by Robert Rothenburg Walking-Owl
  9.  E-mail addresses:
  10.   robert.rothenburg@asb.com
  11.   rrothenb@ic.sunysb.edu
  12.  
  13.  
  14. 1. Introduction
  15. 2. Requirements
  16. 3. Getting started
  17. 4. Features
  18. 5. Initialization
  19. 6. Command line mode
  20. 7. Troubleshooting
  21. 8. Hot key summary
  22. 9. DOS exit codes
  23. 10. Future versions
  24. 11. History
  25. 12. About the author
  26.  
  27.  
  28. 1. Introduction
  29.  
  30.  ACP is a text-screen CD player for DOS. It has many useful features like
  31. EGA and VGA video modes, mouse handling, easy-to-use user interface, command
  32. line mode, and it is easy to configure using initialization file.
  33.  
  34.  This software may only be used for non-commercial and/or non-profit
  35. purposes. You can freely copy and use it as long as none of the files are
  36. modified.
  37.  
  38.  Altough this software was tested carefully, it may still contain bugs.
  39. No guarantees or warrantees are made for the use of this software, nor will
  40. the author be held responsible for damages resulting from the use of this
  41. software. In other words, use on your onw risk.
  42.  
  43.  
  44. 2. Requirements
  45.  
  46.  a. Hardware requirements
  47.     - 80286 or compatible processor
  48.     - CD drive with audio disc support
  49.     - 50 kB of free disk space
  50.     - 50 kB of free conventional memory
  51.  
  52.  b. Software requirements
  53.     These must be installed before starting ACP.
  54.     - MSCDEX or similar CD extension program for DOS
  55.  
  56.  c. Optional
  57.     - VGA for special display features (see chapter 4.)
  58.     - a Microsoft or Mouse System compatible mouse and an installed mouse
  59.       driver (see chapter 4.)
  60.  
  61.  d. Files in the archive
  62.     - ACP.EXE      The program
  63.     - ACP.INI      Initialization file
  64.     - ACP.DOC      This file
  65.     - FILE_ID.DIZ  Information file for BBSs
  66.  
  67.  
  68. 3. Getting started
  69.  
  70.  If you want simply play the entire CD then start ACP and press F2 to open
  71. the drive door. Then insert a music CD into the drive and press F3 to close
  72. the door. Now press 'P' to begin playing.
  73.  You can see two bars with the available hot keys - one on the top, one on
  74. the bottom (see chapter 8.). If you want stop the music, press 'S'. If you
  75. want quit ACP, press F10 (this will also stop playing the CD). If you don't
  76. want to stop the music, press ESC. This will activate Background Playing
  77. (see chapter 4.).
  78.  Or you can type 'ACP E' to eject the door, then 'ACP P' to play the
  79. entire disc, and 'ACP S' to stop playing it (see chapter 6.).
  80.  
  81.  
  82. 4. Features
  83.  
  84.  - Special VGA video modes
  85.      You can use VGA text modes like 80x28, 80x30, 80x34, 80x50 and 80x60.
  86.     These will give you nicer display than the original 80x25, especially
  87.     80x28 and 80x30. Note that in these modes the screen may flicker like
  88.     in graphics mode (depends on your monitor and video card).
  89.  - Initialization file
  90.     You can personalize ACP to your needs by editing ACP.INI (see chapter 5.).
  91.  - Background Playing
  92.      Enjoy the music while running other programs - and this without using
  93.     any memory! In fact this is a feature of the CD drive. You can start
  94.     playing a CD in the program, then quit it by pressing ESC, and the
  95.     playing won't stop. Or simply type 'ACP P' at the DOS prompt (see
  96.     chapter 6.). Note that this is not a TSR (Terminate and Stay Resident)
  97.     portion of the program, it gives only a command block to the CD drive
  98.     to play one or more tracks.
  99.  - Rewind and Forward
  100.     You can use these features to search a part of a track on the CD
  101.     (see chapter 5.)
  102.  - Mouse support
  103.     Just click on a track in the Track box to play that. Or just click in
  104.    the left top corner to exit the program without stopping playing.
  105.    You can use the mouse to do anything - just click on the appropriate
  106.    area on the top or bottom bar.
  107.  - Command line mode
  108.     You can use ACP like a DOS command. See chapter 6. for more information
  109.    about this feature.
  110.  
  111.  
  112. 5. Initialization
  113.  
  114.  ACP uses an initialization file called ACP.INI. This file must be in the
  115. same directory than the main program. You can edit this file with an ASCII
  116. text editor, but there are a few rules:
  117.  - Lines beginning with semicolon (;), double cross (#), star (*), dollar ($),
  118.    percent (%), et (&), space or tabulator are treated as comments.
  119.  - Blank lines and case are ignored.
  120.  - The options must be in keyword=value format.
  121.  - Don't use spaces or tabulators before or after the equal sign (=).
  122.  
  123. Here is a list of the valid keywords and their values:
  124.  
  125. ForceCPU=088|086|186|286|386|486|max
  126.  default: max
  127.   Forces to use the appropriate CPU instructions in some memory handle
  128.  routines. If newer CPU is selected, ACP may speed up a little (well, VERY
  129.  little - but you can say yourself: 'Yeah, this proggy uses the advanced
  130.  features of my 486!'). If max is selected, the correct CPU type will be
  131.  detected, and you can see the detected CPU type in the Status box. Otherwise
  132.  the selected CPU type will be shown.
  133.   If your system hangs up while running ACP, try one of the following:
  134.  - Use the correct CPU type instead of max
  135.  - Use older CPU type than yours to disable 32/16 bit instructions (eg. 086)
  136.  Note that this option works only for those FastMem routines.
  137.  
  138. VideoMode=25|28|30|34|50|60
  139.  default: 25
  140.   Sets the number of the rows on VGA cards. 50 can be used on EGA cards as
  141.  43 line mode. On CGA or Hercules cards only 25 can be used.
  142.  DON'T TRY TO USE MODES, WHICH AREN'T SUPPORTED BY YOUR VIDEO CARD OR MONITOR,
  143.  BECAUSE YOU CAN DAMAGE THESE DEVICES!
  144.  
  145. UseMouse=yes|no
  146.  default: yes
  147.   ACP will use the mouse, if this option is set to yes and a mouse driver is
  148.  installed.
  149.  
  150. CheckSnow=yes|no
  151.  default: no
  152.   On CGA displays the screen may "snow" (it's an interference), so you can
  153.  set this option to yes if you don't like snow. :-)
  154.  
  155. SkipFrames=x     (where x is a number between 1 and 65535)
  156.  default: 375
  157.   Sets the skip time interval in frames (1/75 seconds) when using the Fwd or
  158.  Rew feature (see chapter 4.).
  159.  
  160. MoreBack=yes|no
  161.  default: no
  162.   On EGA and VGA adaptors you can use 16 background colors. On other video
  163.  adaptors the characters will blink if you choose light background colors.
  164.  
  165. InitAction=play|continue|stop|none
  166.  default: none
  167.   Specifies what to do at startup. Play means that ACP should start playing
  168.  the disc from the first track. Continue forces ACP to play the disc
  169.  from the current position. Stop means that ACP should stop playing, and
  170.  none means that ACP shouldn't worry about inserted discs.
  171.   Note that if the drive door is ejected and play selected, ACP closes
  172.  the door and starts playing if there was a disc on the tray.
  173.  
  174. * The following options sets up the colors.
  175.  
  176. * Background colors: black, blue, green, cyan, magenta, red, brown, white
  177. * Foreground colors: gray, lightblue, lightgreen, lightcyan, lightmagenta,
  178. *                    lightred, yellow, brightwhite + background colors
  179. * If you set MoreBack to yes, then you can use the foreground colors as
  180. * background colors (16 foreground colors and 16 background colors).
  181.  
  182. HeaderFore=color
  183.  default: black
  184.   The foreground color of the header line.
  185.  
  186. HeaderBack=color
  187.  default: white
  188.   The background color of the header line.
  189.  
  190. FooterFore=color
  191.  default: black
  192.   The foreground color of the footer line.
  193.  
  194. FooterBack=color
  195.  default: white
  196.   The background color of the footer line.
  197.  
  198. MainFore=color
  199.  default: yellow
  200.   The foreground color of the main screen.
  201.  
  202. MainBack=color
  203.  default: gray
  204.   The background color of the main screen.
  205.  
  206. WindowFore=color
  207.  default: yellow
  208.   The foreground color of the windows.
  209.  
  210. WindowBack=color
  211.  default: lightblue
  212.   The background color of the windows.
  213.  
  214. CurrentFore=color
  215.  default: brightwhite
  216.   The foreground color of the current track.
  217.  
  218. CurrentBack=color
  219.  default: gray
  220.   The background color of the current track.
  221.  
  222.  
  223. 6. Command line mode
  224.  
  225.  If you want to start ACP in command line mode, type at the DOS prompt:
  226. ACP parameter
  227. where 'parameter' is one of the following:
  228.  
  229.  ?     Gives you a small help about using command line mode.
  230.  Pxx   Play track xx. If xx is an invalid track number, ACP plays the first
  231.        track. If xx is not a number, or you entered simply P, then ACP plays
  232.        the entire disc from the first track.
  233.         Note that ACP closes the drive door if it was opened, and plays the
  234.        disc if there was one on the tray.
  235.  S     Stop the CD.
  236.  C     Continue playing from the current position if the disc was stopped.
  237.  R     Reset CD drive.
  238.  
  239.  Case are ignored. If you start ACP without any parameters, it starts in
  240. interactive mode. Note that in command line mode ACP doesn't use ACP.INI.
  241.  
  242.  
  243. 7. Troubleshooting
  244.  
  245.  - If ACP hangs up, try other setting for ForceCPU (see chapter 5.).
  246.  - I don't tested ACP under Windows 3.x / Windows 95, there may strange
  247.    things happen.
  248.  
  249.  
  250. 8. Hot key summary
  251.  
  252.  Top bar
  253.  
  254. [click in the left corner]: see ESC.
  255. P: Play the entire CD from the current track.
  256. S: Stop playing.
  257. C: Continue a stopped track.
  258. ESC: Background Playing (see chapter 4.).
  259.  
  260.  Bottom bar
  261.  
  262. Up arrow: Play previous track.
  263. Down arrow: Play next track.
  264. Left arrow: Search backward (rewind).
  265. Right arrow: Search forward.
  266. F2: Eject the drive door.
  267. F3: Close drive door and read disc information.
  268. F4: Read disc information (use this if you closed the door manually).
  269. F9: Reset CD drive.
  270. F10: Stop playing and exit the program.
  271.  
  272.  You can see all tracks if you click on the top or bottom border of the
  273. Track box.
  274.  
  275.  
  276. 9. DOS exit codes
  277.  
  278.  You can use these from batch files monitoring the ERRORLEVEL variable.
  279. The codes are:
  280.  
  281.   0:    Normal exit
  282. 255:    Wrong CPU type
  283. 254:    Background playing
  284. 253:    MSCDEX not installed
  285. 252:    Syntax error in ACP.INI
  286. 251:    Program usage error
  287. 250:    Command successfully executed
  288. 249:    Help requested
  289. 248:    Command execution failed
  290. others: I/O error while reading ACP.INI
  291.  
  292.  Error codes from 248 to 251 are command line mode errors.
  293.  
  294.  
  295. 10. Future versions
  296.  
  297.  In the future releases of ACP I want to add some new features:
  298.   - Programmable playing
  299.   - Shuffle (random playing)
  300.   - Language support (English, German, Hungarian)
  301.  
  302.  Future releases will be available on ftp://garbo.uwasa.fi/pc/cd and
  303. its mirror sites. The name of the packed file will be acp_xxx.zip where
  304. xxx is the version number (so 1.00 -> 100).
  305.  
  306.  
  307. 11. History
  308.  
  309.  Version 1.00 03/26/96
  310.   - The first release
  311.  
  312.  Version 1.01 05/20/96
  313.   - Added command line support (see chapter 6.).
  314.   - Added new option InitAction (see chapter 5.).
  315.   - Selecting 'max' for ForceCPU caused to run with 8086 instructions, this
  316.     bug is now fixed.
  317.   - You can see the selected CPU type in the Status box. If you select 'max',
  318.     the detected CPU type will be shown.
  319.   - Detailed informations about startup process.
  320.   - Option CurentFore and CurentBack renamed to CurrentFore and CurrentBack.
  321.   - Some color names renamed (see chapter 5.).
  322.   - Optimized code parts.
  323.   - Minor bug fixes.
  324.  
  325.  
  326. 12. About the author
  327.  
  328.  I study at Technical University of Budapest, Faculty of Mechanical
  329. Engineering. I wrote this program because I did not have any well-working,
  330. nice CD players. But now... :-)
  331.  
  332.  If you have any problems, questions, bug reports or comments
  333. please contact me:
  334.  - by e-mail: keki@goliat.eik.bme.hu
  335.               keki@atlantis.bme.hu
  336.  - by snail-mail: Kékesi András
  337.                   Budapest
  338.                   Pálya u. 2b
  339.                   H-1012
  340.                   HUNGARY/EUROPE
  341.